home *** CD-ROM | disk | FTP | other *** search
/ Apple WWDC 1996 / WWDC96_1996 (CD).toast / Technology Materials / MacOS 8 Resources / Developer Tools / Mac OS 8 Interfaces & Libraries / Interfaces / AIncludes / MemAllocators.a < prev    next >
Encoding:
Text File  |  1996-05-01  |  3.9 KB  |  173 lines  |  [TEXT/MPS ]
  1. ;
  2. ;    File:        MemAllocators.a
  3. ;
  4. ;    Version:    Technology:    
  5. ;                Release:    Universal Interfaces 3.0d3 on Copland DR1
  6. ;
  7. ;    Copyright:    © 1984-1996 by Apple Computer, Inc.  All rights reserved.
  8. ;
  9. ;    Bugs?:        If you find a problem with this file, send the file and version
  10. ;                information (from above) and the problem description to:
  11. ;
  12. ;                    Internet:    apple.bugs@applelink.apple.com
  13. ;                    AppleLink:    APPLE.BUGS
  14. ;
  15. ;
  16.     IF &TYPE('__MEMALLOCATORS__') = 'UNDEFINED' THEN
  17. __MEMALLOCATORS__ SET 1
  18.  
  19.     IF &TYPE('__TYPES__') = 'UNDEFINED' THEN
  20.     include 'Types.a'
  21.     ENDIF
  22.     IF &TYPE('__MIXEDMODE__') = 'UNDEFINED' THEN
  23.     include 'MixedMode.a'
  24.     ENDIF
  25.     IF FOR_SYSTEM8_PREEMPTIVE THEN
  26. ;
  27. ; *    NOTE:  Callers of the MemAllocators API are gauranteed at least
  28. ; *    kMemAllocatorAlignment_Minimum alignment of all allocated blocks.
  29. ;
  30.  
  31. kMemAllocatorAlignment_Minimum    EQU        2                    ; (4 Byte Alignment Gaurantee) 
  32.  
  33.  
  34. ;
  35. ; *    Handle support
  36. ;
  37. ;
  38. ; extern OSStatus MemNewHandle(MemAllocatorRef inAllocator, ByteCount inSize, Handle *outHandle)
  39. ;
  40.     IF GENERATINGCFM THEN
  41.         IMPORT_CFM_FUNCTION MemNewHandle
  42.     ENDIF
  43.  
  44. ;
  45. ; extern OSStatus MemNewHandleClear(MemAllocatorRef inAllocator, ByteCount inSize, Handle *outHandle)
  46. ;
  47.     IF GENERATINGCFM THEN
  48.         IMPORT_CFM_FUNCTION MemNewHandleClear
  49.     ENDIF
  50.  
  51. ;
  52. ; extern OSStatus MemDisposeHandle(Handle *ioHandle)
  53. ;
  54.     IF GENERATINGCFM THEN
  55.         IMPORT_CFM_FUNCTION MemDisposeHandle
  56.     ENDIF
  57.  
  58. ;
  59. ; extern OSStatus MemSizeHandle(ByteCount inSize, Handle inHandle)
  60. ;
  61.     IF GENERATINGCFM THEN
  62.         IMPORT_CFM_FUNCTION MemSizeHandle
  63.     ENDIF
  64.  
  65. ;
  66. ; extern OSStatus MemGetHandleSize(Handle inHandle, ByteCount *outSize)
  67. ;
  68.     IF GENERATINGCFM THEN
  69.         IMPORT_CFM_FUNCTION MemGetHandleSize
  70.     ENDIF
  71.  
  72. ;
  73. ; * Fixed block support
  74. ;
  75. ;
  76. ; extern OSStatus MemNewFixed(MemAllocatorRef inAllocator, ByteCount inSize, void **outMemory)
  77. ;
  78.     IF GENERATINGCFM THEN
  79.         IMPORT_CFM_FUNCTION MemNewFixed
  80.     ENDIF
  81.  
  82. ;
  83. ; extern OSStatus MemNewFixedClear(MemAllocatorRef inAllocator, ByteCount inSize, void **outMemory)
  84. ;
  85.     IF GENERATINGCFM THEN
  86.         IMPORT_CFM_FUNCTION MemNewFixedClear
  87.     ENDIF
  88.  
  89. ;  inAlignment must be in the range 0..31 
  90. ;
  91. ; extern OSStatus MemNewFixedAligned(MemAllocatorRef inAllocator, ByteCount inSize, UInt32 inAlignment, void **outMemory)
  92. ;
  93.     IF GENERATINGCFM THEN
  94.         IMPORT_CFM_FUNCTION MemNewFixedAligned
  95.     ENDIF
  96.  
  97. ;  inAlignment must be in the range 0..31 
  98. ;
  99. ; extern OSStatus MemNewFixedAlignedClear(MemAllocatorRef inAllocator, ByteCount inSize, UInt32 inAlignment, void **outMemory)
  100. ;
  101.     IF GENERATINGCFM THEN
  102.         IMPORT_CFM_FUNCTION MemNewFixedAlignedClear
  103.     ENDIF
  104.  
  105. ;
  106. ; extern OSStatus MemDisposeFixed(MemAllocatorRef inAllocator, ByteCount inSize, void **ioMemory)
  107. ;
  108.     IF GENERATINGCFM THEN
  109.         IMPORT_CFM_FUNCTION MemDisposeFixed
  110.     ENDIF
  111.  
  112. ;
  113. ; * Convenience macros
  114. ;
  115. ;
  116. ; * Variable block support
  117. ;
  118. ;
  119. ; extern OSStatus MemNewVariable(MemAllocatorRef inAllocator, ByteCount inSize, void **outMemory)
  120. ;
  121.     IF GENERATINGCFM THEN
  122.         IMPORT_CFM_FUNCTION MemNewVariable
  123.     ENDIF
  124.  
  125. ;
  126. ; extern OSStatus MemNewVariableClear(MemAllocatorRef inAllocator, ByteCount inSize, void **outMemory)
  127. ;
  128.     IF GENERATINGCFM THEN
  129.         IMPORT_CFM_FUNCTION MemNewVariableClear
  130.     ENDIF
  131.  
  132. ;
  133. ; extern OSStatus MemDisposeVariable(MemAllocatorRef inAllocator, void **ioMemory)
  134. ;
  135.     IF GENERATINGCFM THEN
  136.         IMPORT_CFM_FUNCTION MemDisposeVariable
  137.     ENDIF
  138.  
  139. ;
  140. ; extern OSStatus MemGetVariableSize(MemAllocatorRef inAllocator, void *inMemory, ByteCount *outSize)
  141. ;
  142.     IF GENERATINGCFM THEN
  143.         IMPORT_CFM_FUNCTION MemGetVariableSize
  144.     ENDIF
  145.  
  146. ;
  147. ; extern OSStatus MemSizeVariable(MemAllocatorRef inAllocator, ByteCount inSize, void **ioMemory)
  148. ;
  149.     IF GENERATINGCFM THEN
  150.         IMPORT_CFM_FUNCTION MemSizeVariable
  151.     ENDIF
  152.  
  153. ;
  154. ; *    Debugging Support
  155. ;
  156. ;
  157. ; extern OSStatus MemCheckAllocator(MemAllocatorRef inAllocator)
  158. ;
  159.     IF GENERATINGCFM THEN
  160.         IMPORT_CFM_FUNCTION MemCheckAllocator
  161.     ENDIF
  162.  
  163. ;
  164. ; extern OSStatus MemForceFailure(MemAllocatorRef inAllocator, OSStatus inForceFailure)
  165. ;
  166.     IF GENERATINGCFM THEN
  167.         IMPORT_CFM_FUNCTION MemForceFailure
  168.     ENDIF
  169.  
  170.     ENDIF
  171.     ENDIF ; __MEMALLOCATORS__ 
  172.  
  173.